NE RSet 


as — Scotland 





Scottish Address Directory (SAD) 
Technical specification 


November 2019 


Table of Contents 


We Back UU II AE AAA HE AI WA MUA ight eal Chat hanes 3 
2: Contents of the Scottish Address DIE Yi KA KEKI UHAKIKI ARE EA Eee aia AEA EEFKES ERRERA kii 4 
Aa aa Wa Maa aN WA KA KA AA AA AA AA Aa T E UA KA AA E AAA AA aa AK BA Ba te 13 


3. Glossary 


2 
© Crown copyright 2019 


1. Background 


NRS Geography create a new quarterly Scottish Address Directory (SAD) containing address information, classification of type and three 
unique identifiers, the Royal Mail Unique Delivery Point Reference Number (UDPRN), the One Scotland Gazetteer (OSG) Unique Property 
Reference Number (UPRN) and the OSG Unique Street Reference Number (USRN). 


By comparing the contents of the previous version of the Ordnance Survey (OS) AddressBase product against the latest version, an updated 
address list is created. Additional information is then added from a suite of Geography addressing products to create the newest version of the 
SAD. This is done using the unique reference numbers which also allow the SAD to be linked to a number of other datasets which hold these 
identifiers. 
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2. Contents of the Scottish Address Directory 


The directory is in the format of a database held in SQL Server and holds 4 tables, which will be converted to text or SAS files as per user 
requirements:- 


1. Address 
2. AlternativeAddress 
3. HistoricalAddress 


1 


4. MIS 


Address 


This is the main Scottish Address Directory table which contains current and provisional addresses. 






































Field Name Index Data Size | Nullable Accepted Data Source Description 
Type Format 
PostcodePostal VarChar | 8 N G4 9QT or G78 | AddressBase A valid postcode in the format prescribed by the 
1WD or AB12 Table 21 Royal Mail. Comprised of, for example 
7FY Postcode_Locator field Area EH 
District 10 
Sector 4 
Unit SU 
If UDPRN present this field should be populated from 
Royal Mail PAF Postcode field 
Postcode VarChar | 9 N G4 9QTA or AddressBase A valid postcode in the format prescribed by the 
AB12 7FY Table 21 Royal Mail and if the address falls within a postcode 
Postcode_Locator field / Scottish | split across council areas, island to island, island to 
Postcode Directory mainland or Scotland/England border, this gives the 
split postcode it lies in. 
SUPostcode VarChar | 9 Y G4 9QT or Scottish Postcode Directory If postcode is a large user this is its linked small user 
G78 1WD or postcode 
AB12 7FY 
PostcodeTypeAB Char 1 N D,N, Corl AddressBase Indicates if it is a matched record which receives post 
Table 21 (D), a child record (C), a local authority assigned 
Postal_Address field postcode (L) or a postcode which may not receive 
post (N). 
PostcodeTypePAF Char 1 Y Lors Royal Mail PAF Indicates if it is a small user or large user postcode 
Postcode Type field 
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Field Name Index Data Size | Nullable Accepted Data Source Description 
Type Format 
POBox\Indicator Char 1 Y Y or null AddressBase Indicates if the address is a PO Box 
Table 32 
Classification _Code field 
SplitPostcodelndicator Char 1 N YorN Geography Indicates if the postcode is split across council areas, 
SplitPostcode database Scotland/England border or by water (island to island, 
island to mainland). 
Organisation VarChar | 100 Y AddressBase Name of occupying organisation. 
Table 31 If UDPRN present this field should be populated from 
Organisation field Royal Mail PAF OrganisationName field 
Department VarChar | 60 Y Royal Mail PAF Name of the subdivision of an organisation for 
Department field delivery purposes 
Property VarChar | 192 Y AddressBase Name of the sub-building (e.g. flat) 
Table 24 If UDPRN present this field should be populated from 
all SAO fields + PAO_ Text field Royal Mail PAF Sub Building and Building fields 
BuildingNumber VarChar | 12 Y AddressBase Number of building. 
Table 24 If UDPRN present this field should be populated from 
PAO numbers + suffix fields Royal Mail Number field 
Street VarChar | 160 Y AddressBase Name of street the address is in. 
Table 15 If UDPRN present this field should be populated from 
Street_Description field Royal Mail PAF DependentThoroughfare and 
Thoroughfare fields 
Locality VarChar | 70 Y AddressBase Name of locality the address is in. 
Table 15 If UDPRN present this field should be populated from 
Locality_Name field Royal Mail PAF DoubleDependentLocality and 
DependentLocality fields 
Town VarChar | 30 N AddressBase Name of town the address is in. 
Table 15 If UDPRN present this field should be populated from 
Town_Name field Royal Mail PAF Town field 
MultiOccupancyCount Integer 4 N 0 to 1000 AddressBase Count of all child UPRN’s for the record 
Table 21 
Multi_OCC_COUNT field 
UPRN P VarChar | 12 N Uses only AddressBase Unique Property Reference Number. 
numbers 0 to9 | Table 24 
UPRN field 
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Field Name Index Data Size | Nullable Accepted Data Source Description 
Type Format 
ParentUPRN VarChar | 12 Y Uses only AddressBase Unique reference number of the parent record for the 
numbers 0 to9 | Table 21 address (i.e. the building shell for flats) 
PARENT_UPRN field 
UDPRN Char 8 Y Contains AddressBase Unique Delivery Point Reference. 
leading 0’s. Table 28 
Uses only RM_UDPRN field 
numbers 0 to 9 
USRN VarChar | 8 N Uses only AddressBase Unique Street Reference Number. 
numbers 0 to9 | Table 24 
USRN field 
CouncilAreaCode VarChar | 9 N $12000005 to Scottish Postcode Directory The 9 digit council area code the address falls into 
$12000050 CouncilArea2019Code 
LocalCustodianCode VarChar | 4 N 9000 to 9079 AddressBase The code used by local authorities to indicate who 
Table 21 has ownership for the address 
Local Custodian Code field 
CountOfEntrances Integer 3 N 1 to 999 AddressBase Number of possible entrances, by street, for an 
Table 24 address 
UPRN to USRN count 
CountOfAlternativeAddress Integer 3 Y 2 to 999 AddressBase Number of possible variations for the address record 
Table 24 (e.g. Flat 1 or Flat A) where greater than 1 
UPRN count 
ClassificationAB VarChar | 6 Y AddressBase The classification of the address as sourced from the 
Table 32 Local Land and Property Gazetteers and from OS (for 
CLASSIFICATION_CODE full list of classifications see, 
https://www.ordnancesurvey.co.uk/business-and- 
government/help-and- 
support/products/addressbase-premium.html 
CElIndicator Char 1 N YorN NRS communal establishment | Indicates if the address is deemed to be a CE by 
register Geography. 
GridRefEasting VarChar | 6 Y AddressBase Grid Reference Easting Position. 
Table 21 
X_Coordinate field 
GridRefNorthing VarChar | 7 Y AddressBase Grid Reference Northing Position. 
Table 21 




















Y_Coordinate field 











6 


© Crown copyright 2019 















































Field Name Index Data Size | Nullable Accepted Data Source Description 
Type Format 

RPC Integer 1 N 1,2,3,4,5,9 AddressBase Indicates the accuracy value of the coordinates 
Table 21 allocated to the address (according to OS) 
RPC field 

Latitude Double N AddressBase Address co-ordinates in degrees latitude 
Table 21 
Latitude field 

Longitude Double N AddressBase Address co-ordinates in degrees longitude 
Table 21 
Longitude field 

DateOflntroduction Date Y Geography Date the record was added to the directory 

CrossReference Char Y AddressBase Primary key of corresponding record in an external 
Table 23 dataset (e.g. MasterMap AL2 TOID) 
Cross_Reference Field 

DateLastChanged Date Y AddressBase Date Address Changed 
UPRN to UPRN comparison 
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2. AlternativeAddress 
This is a table listing the different variations of an address (e.g. Flat 1, 10 High Street or Flat 10/1 High Street) 
































Field Name Index Data Type Size | Nullable Accepted Format Data Source Description 
ObjectID P Automated N Uses only 0-9 System Unique reference number assigned to a 
record 
UPRN P VarChar 12 N Uses only numbers 0 | AddressBase Unique Property Reference Number. 
to 9 Table 24 
UPRN field 
PostcodePostal VarChar 8 N G4 9QT or G78 1WD | AddressBase A valid postcode in the format prescribed by 
or AB12 7FY Table 21 the Royal Mail. Comprised of, for example 
Postcode_Locator field Area EH 
District 10 
Sector 4 
Unit SU 
If UDPRN present this field should be 
populated from Royal Mail PAF Postcode 
field 
Property VarChar 192 Y AddressBase Name of the sub-building (e.g. flat). 
Table 24 
all SAO fields + PAO_ Text field 
BuildingNumber VarChar 12 Y AddressBase Number of building. 
Table 24 
PAO numbers + suffix fields 
Street VarChar 160 Y AddressBase Name of street the address is in. 
Table 15 
Street_Description field 
Locality VarChar 70 Y AddressBase Name of locality the address is in. 
Table 15 
Locality_Name field 
Town VarChar 30 N AddressBase Name of town the address is in. 
Table 15 




















Town_Name field 
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3. HistoricalAddress 
This is a table listing any deleted or changed addresses since the previous data extract. 












































Field Name Index Data Type Size | Nullable Accepted Format Data Source Description 
ObjectID P Automated N Uses only 0-9 System Unique reference number assigned to a record 
UPRN P VarChar 12 N Uses only numbers AddressBase Unique Property Reference Number. 
0to9 Table 24 
UPRN field 
Postcode VarChar 9 N G4 9QTA or AddressBase A valid postcode in the format prescribed by the 
AB12 7FY Table 21 Royal Mail and if the address falls within a 
Postcode_Locator field / Scottish | postcode split across council areas, island to 
Postcode Directory island, island to mainland or Scotland/England 
border, this gives the split postcode it lies in. 
PostcodePostal VarChar 9 N G4 9QT or AddressBase A valid postcode in the format prescribed by the 
G78 1WD or Table 21 Royal Mail. Comprised of, for example 
AB12 7FY Postcode_ Locator field Area EH 
District 10 
Sector 4 
Unit SU 
Property VarChar 192 Y AddressBase Name of the sub-building (e.g. flat). 
Table 24 
all SAO fields + PAO_ Text field 
BuildingNumber VarChar 12 Y AddressBase Number of building. 
Table 24 
PAO numbers + suffix fields 
Street VarChar 160 Y AddressBase Name of street the address is in. 
Table 15 
Street_Description field 
Locality VarChar 70 Y AddressBase Name of locality the address is in. 
Table 15 
Locality_Name field 
Town VarChar 30 N AddressBase Name of town the address is in. 
Table 15 
Town_Name field 
DateLastChanged Date Y AddressBase Date Address Changed 
UPRN to UPRN comparison 
DateOfDeletion Date Y Geography Date the record was marked as a deleted address 
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4. MIS (management information statistics) 


This table contains details of the number of new, deleted and changed postcodes and addresses on SAD. 































































































Field Name Data Type Description 

VersionOfTheData VarChar The version or Epoch of the data used (e.g. 2019Q3). 

TotalNoOfAddressRecords Integer Count of the total number of records in the Addresses table 

TotalNoOfNewAddressRecords Integer Count of new records since previous version 

TotalNoOfNewAddressRecordsResidential Integer Count of new records since previous version, where AddressBase classification = R* 

TotalNoOfNewAddressRecordsNonResidential Integer Count of new records since previous version, where AddressBase classification = not R* 

TotalNoOfDeletedAddressRecords Integer Count of deleted records since previous version 

TotalNoOfChangedAddressRecords Integer Count of records with a change since previous version 

TotalNoOfChangedAddressRecordsResidential Integer Count of records with a change since previous version, where AddressBase classification = R* 

TotalNoOfChangedAddressRecordsNonResidential Integer Count of records with a change since previous version, where AddressBase classification = not 
R* 

TotalNoOfNewPostcodes Integer Count of new postcodes since previous version 

TotalNoOfExistingPostcodesWithNewAddresses Integer Count of existing postcodes which have had records added since previous version 

TotalNoOfExistingPostcodesWithNewAddressesResidential Integer Count of existing postcodes which have had records added since previous version, where 
AddressBase classification = R* 

TotalNoOfExistingPostcodesWithNewAddressesNonResidential Integer Count of existing postcodes which have had records added since previous version, where 
AddressBase classification = not R* 

TotalNoOfDeletedPostcodes Integer Count of deleted postcodes since previous version 

TotalNoOfExistingPostcodesWithDeletedAddresses Integer Count of existing postcodes which have had records removed since previous version 

TotalNoOfAddressWithADifferantPostcode Integer Count of records which have changed postcode since previous version 

TotalNoOfAddressWithADifferantPostcode Residential Integer Count of records which have changed postcode since previous version, where AddressBase 
classification = R* 

TotalNoOfAddressWithADifferantPostcodeNonResidential Integer Count of records which have changed postcode since previous version, where AddressBase 
classification = not R* 

TotalNoOfAddressesMatchedToPAF Integer Count of records with both a UPRN and UDPRN 

TotalNoOfAddressesNotMatchedToPAF Integer Count of records without a UDPRN 

TotalNoOfMultiOccupancyAddresses Integer Count of records with a multi occupancy count >1 

CountOfMultiOccupancyAddresses Integer Total number of records classed as multi-occupancy by the local authority 

TotalNoOfNonPostalAddresses Integer Count of records classed as not receiving post 

TotalNoOfClassificationCommercial Integer Count of records with classification beginning ‘C’ on AddressBase 

TotalNoOfClassificationLand Integer Count of records with classification beginning ‘L’ on AddressBase 

TotalNoOfClassificationMilitary Integer Count of records with classification beginning ‘M’ on AddressBase 

TotalNoOfClassificationOther Integer Count of records with classification beginning ‘O’ on AddressBase 

TotalNoOfClassificationParentShell Integer Count of records with classification beginning ‘P’ on AddressBase 
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Field Name Data Type Description 

TotalNoOfClassificationResidential Integer Count of records with classification beginning ‘R’ on AddressBase 
TotalNoOfClassificationUnclassified Integer Count of records with classification beginning ‘U’ on AddressBase 
TotalNoOfClassificationXDualUse Integer Count of records with classification beginning ‘X’ on AddressBase 
TotalNoOfClassificationZObjectOfinterest Integer Count of records with classification beginning ‘Z’ on AddressBase 
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There will also be 3 supplementary lookup files which will be held as csv files; 
1. PostcodeTypeAB_ lookup 
2. RPC_lookup 
3. CouncilAreaCode_lookup 

1. PostcodeTypeAB_ lookup 


This gives further details of the postcode type codes used on AddressBase. 
































Field Name Data Type | Size Data Source Description 
PostcodeType VarChar 1 AddressBase Premium Code used to describe the record as postal or not as defined by 
AddressBase logic 
PostcodeTypeDescription VarChar 75 AddressBase Premium Extended description pf the postal types defined in AddressBase 
2. RPC_lookup 


This gives an indication of the accuracy of the coordinates assigned to the address, as determined by Ordnance Survey. 











Field Name Data Type Size Data Source Description 

RPC Integer 1 AddressBase Premium Code used to identify the accuracy of the coordinates allocated to the 
address 

RPCDescription VarChar 350 AddressBase Premium Extended description of the accuracy of the coordinates allocated to the 
address 























3. CouncilAreaCode_lookup 


This table gives details of the council area the address record falls within. 
































Field Name Data Type | Size | Data Source Description 
CouncilAreaCode VarChar 9 Scottish Postcode Directory A code that identifies a Council Area 
LocalCustodianCode Integer 4 AddressBase Premium A code that identifies the custodian of the data 
CouncilAreaName VarChar 250 Scottish Postcode Directory Official name that identifies a Council Area 
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3. Glossary 


AddressBase (AB) 
An Ordnance Survey product which combines the One Scotland Gazetteer (OSG) with matched address information from the Royal Mail 
Postcode Address File (PAF). 


Three versions of the product are available; 
1. AddressBase — list of the PAF matched addresses 
2. AddressBase Plus — OSG and matched PAF address information for live records only 
3. AddressBase Premium — full OSG data with matched PAF addresses [this is the version Geography use] 


Communal Establishment Register (CER) 
A dataset of Scottish addresses identified as being a communal Establishment, and associated information about each address 


Geoplace 
Partnership between local government, in England and Wales, and Ordnance Survey. They are the custodians of the National Address 
Gazetteer and the National Street Gazetteer for England and Wales. 


Matched Address 
A property record for which an entry has been found on the Royal Mail Postcode Address File and the One Scotland Gazetteer. A link has 
been created using the unique identifiers from both datasets. 


One Scotland Gazetteer (OSG) 
Scottish address list combining the 32 council address gazetteers. It contains address and property lifecycle information. Also see Council 
Address Gazetteer (CAG). 


Royal Mail Postcode Address File (PAF) 

The Postcode Address File is a database of all UK addresses and postcodes. It is produced by Royal Mail and is continuously updated. NRS, 
receives this file on a quarterly basis through a third party provider. This file provides the information for the digitising of new postcodes and the 
removal of deleted postcodes 


Unique Delivery Point Reference Number (UDPRN) 
Unique identifier allocated to each delivery point on the Royal Mail Postcode Address File. 
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Unique Property Reference Number (UPRN) 
Unique identifier allocated to each property record on the One Scotland Gazetteer. 


Unique Street Reference Number (USRN) 
Unique identifier allocated to each street entry on the One Scotland Gazetteer. 
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